.\"   $Id: GENLIB_COPY_UP_SEG.3,v 1.1 2002/03/08 14:08:09 fred Exp $
.\" @(#)GENLIB_COPY_UP_SEG.3 2.11 91/08/22 ; Labo Cao-vlsi; Author : Frederic Petrot
.if t \{\
.so man1/alc_contents.mac
.XS \n%
.ti 0.2i
GENLIB_COPY_UP_SEG
.XE \}
.TH GENLIB_COPY_UP_SEG.3 "October 1, 1997" "ASIM/LIP6" "PROCEDURAL GENERATION LANGUAGE"
.SH NAME
GENLIB_COPY_UP_SEG \- copy a physical segment from an instance in the current
figure
.SH SYNOPSIS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
void GENLIB_COPY_UP_SEG(oldname, insname, newname)
char \(**oldname, \(**insname, \(**newname;
.ft R
.fi
.so man1/alc_origin.1
.SH PARAMETERS
.TP 20
\fIoldname\fP
Name of the segment in the instance
.TP
\fIinsname\fP
Name of the instance in the which the segment is to be searched for
.TP
\fInewname\fP
Name to be given to the segment in the current figure
.SH DESCRIPTION
\fBCOPY_UP_SEG\fP adds a segment in the current layout cell.
All the segment's attributes are copied from the first found segment called
\fIoldname\fP in the instance \fIinsname\fP.
The new segment is given the name \fInewname\fP. The main purpose of this
function is to rename a segment, so it can be used later, when extracting a
layout.
.SH ERRORS
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"GENLIB_COPY_UP_SEG impossible : missing GENLIB_DEF_PHFIG"
.ft R
.RS
No figure has been yet specified by a call to \fBDEF_PHFIG\fP. So it isn't
possible to place a segment inside it.
you must call \fBDEF_PHFIG\fP before any other layout action.
.RE
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"illegal getphins : instance \fIinsname\fP does not exist"
.ft R
.RS
The instance called \fIinsname\fP does not currently belong to the figure.
.RE
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"GENLIB_COPY_UP_SEG impossible : segment \fIsegname\fP does not exist"
.ft R
.RS
The segment \fIsegname\fP does not exist in the model of the instance
\fIinsname\fP.
.RE
.SH EXAMPLE
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
main()
{
	/\(** Create a figure to work on  \(**/
	GENLIB_DEF_PHFIG("cell");
	GENLIB_PLACE("z2l_y", "r1", NOSYM, 23L, 54L);
	/\(** Put a segment \(**/
	GENLIB_COPY_UP_SEG("mux0_s", "r1", "out_s");
	/\(** Save that on disk \(**/
	GENLIB_SAVE_PHFIG();
}
.ft R
.fi
.SH SEE ALSO
.BR genlib (1),
.BR GENLIB_DEF_PHFIG (3),
.BR GENLIB_SAVE_PHFIG (3),
.BR GENLIB_PHSEG (3),
.BR GENLIB_THRU_H (3),
.BR GENLIB_THRU_CON_H (3),
.BR GENLIB_THRU_V (3),
.BR GENLIB_THRU_CON_V (3),
.BR GENLIB_WIRE1 (3),
.BR GENLIB_WIRE2 (3),
.BR GENLIB_WIRE3 (3).


.so man1/alc_bug_report.1

